home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / standard / ldlread.z / ldlread
Text File  |  1998-10-30  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4. LLLLDDDDLLLLRRRREEEEAAAADDDD((((3333XXXX))))                                                        LLLLDDDDLLLLRRRREEEEAAAADDDD((((3333XXXX))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ldlread, ldlinit, ldlitem - manipulate line number entries of a common
  10.      object file function
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddiiiioooo....hhhh>>>>
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ffffiiiilllleeeehhhhddddrrrr....hhhh>>>>
  15.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyymmmmssss....hhhh>>>>
  16.      ####iiiinnnncccclllluuuuddddeeee <<<<llllddddffffccccnnnn....hhhh>>>>
  17.  
  18.  
  19.      iiiinnnntttt llllddddllllrrrreeeeaaaadddd ((((ldptr, fcnindx, linenum, linent))))
  20.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  21.      lllloooonnnngggg fcnindx;;;;
  22.      uuuunnnnssssiiiiggggnnnneeeedddd sssshhhhoooorrrrtttt linenum;;;;
  23.      LLLLIIIINNNNEEEERRRR ****linent;;;;
  24.  
  25.      iiiinnnntttt llllddddlllliiiinnnniiiitttt ((((ldptr, fcnindx))))
  26.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  27.      lllloooonnnngggg fcnindx;;;;
  28.  
  29.      iiiinnnntttt llllddddlllliiiitttteeeemmmm ((((ldptr, linenum, linent))))
  30.      LLLLDDDDFFFFIIIILLLLEEEE ****ldptr;;;;
  31.      uuuunnnnssssiiiiggggnnnneeeedddd sssshhhhoooorrrrtttt linenum;;;;
  32.      LLLLIIIINNNNEEEERRRR ****linent;;;;
  33.  
  34. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  35.      _l_d_l_r_e_a_d searches the line number entries of the common object file
  36.      currently associated with _l_d_p_t_r.  _l_d_l_r_e_a_d begins its search with the line
  37.      number entry for the beginning of a function and confines its search to
  38.      the line numbers associated with a single function.  The function is
  39.      identified by _f_c_n_i_n_d_x, which is the index of its local symbols entry in
  40.      the object file symbol table.  _l_d_l_r_e_a_d reads the entry with the smallest
  41.      line number equal to or greater than _l_i_n_e_n_u_m into _l_i_n_e_n_t.
  42.  
  43.      _l_d_l_i_n_i_t and _l_d_l_i_t_e_m together do exactly the same function as _l_d_l_r_e_a_d.
  44.      After an initial call to _l_d_l_r_e_a_d or _l_d_l_i_n_i_t, _l_d_l_i_t_e_m can be used to
  45.      retrieve a series of line number entries associated with a single
  46.      function.  _l_d_l_i_n_i_t simply finds the line number entries for the function
  47.      identified by _f_c_n_i_n_d_x. _l_d_l_i_t_e_m finds and reads the entry with the
  48.      smallest line number equal to or greater than _l_i_n_e_n_u_m into _l_i_n_e_n_t.
  49.  
  50.      _l_d_l_r_e_a_d, _l_d_l_i_n_i_t, and _l_d_l_i_t_e_m each return either SSSSUUUUCCCCCCCCEEEESSSSSSSS or FFFFAAAAIIIILLLLUUUURRRREEEE.  If
  51.      no line number entries exist in the object file, if _f_c_n_i_n_d_x does not
  52.      index a function entry in the symbol table, or if it finds no line number
  53.      equal to or greater than _l_i_n_e_n_u_m, _l_d_l_r_e_a_d fails.  If no line number
  54.      entries exist in the object file or if _f_c_n_i_n_d_x does not index a function
  55.      entry in the symbol table, _l_d_l_i_n_i_t fails.  If it finds no line number
  56.      equal to or greater than _l_i_n_e_n_u_m, _l_d_l_i_t_e_m fails.
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLDDDDLLLLRRRREEEEAAAADDDD((((3333XXXX))))                                                        LLLLDDDDLLLLRRRREEEEAAAADDDD((((3333XXXX))))
  71.  
  72.  
  73.  
  74.      The programs must be loaded with the object file access routine library
  75.      lllliiiibbbbmmmmlllldddd....aaaa.
  76.  
  77. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.      ldclose(3X), ldopen(3X), ldtbindex(3X), ldfcn(4).
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.